<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
        <title>RVM : MMTk Tutorial Preliminaries</title>
        <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>

    <body>
        <div id="page">
            <div id="main">
                <div id="main-header" class="pageSectionHeader">
                    <h1 id="title-heading" class="pagetitle">
                                                <span id="title-text">
                            RVM : MMTk Tutorial Preliminaries
                        </span>
                    </h1>

                    <div class="page-metadata">
                        <p>This page last changed on Dec 21, 2011 by <font color="#0050B2">dgrove</font>.</p>
                    </div>
                </div>

                <div id="content" class="view">
                    <div id="main-content" class="wiki-content group">
                    <h5 id="MMTkTutorialPreliminaries-GettingMMTkandJikesRVMandEclipseworking">Getting MMTk and Jikes RVM and Eclipse working.</h5><ol><li><a class="createlink" href="/pages/createpage.action?spaceKey=RVM&amp;title=Get%2BThe%2BSource&amp;linkCreation=true&amp;fromPageId=114788238">Download</a> Jikes RVM version 3.0.1 or later</li><li>Ensure you can <a class="createlink" href="/pages/createpage.action?spaceKey=RVM&amp;title=Building%2Bthe%2BRVM&amp;linkCreation=true&amp;fromPageId=114788238">Build</a> and <a class="createlink" href="/pages/createpage.action?spaceKey=RVM&amp;title=Running%2Bthe%2BRVM&amp;linkCreation=true&amp;fromPageId=114788238">Run</a> the RVM.</li><li><p>Ensure you can build and run the <code>BaseBaseNoGC</code> configuration (build with: <code>bin/buildit localhost BaseBaseNoGC</code>, run with something like:</p><pre>dist/BaseBaseNoGC_ia32-linux/rvm HelloWorld</pre><p>Note that this configuration <em>does</em> <em>not</em> perform garbage collection so can only run small benchmarks which do not exhaust available memory. This configuration will be used as the basis for the tutorial.</p></li><li>Ensure that your source is <a class="createlink" href="/pages/createpage.action?spaceKey=RVM&amp;title=Editing%2BJikesRVM%2Bin%2Ban%2BIDE&amp;linkCreation=true&amp;fromPageId=114788238">successfully imported</a> (and editable) within an IDE such as Eclipse.</li></ol><h5 id="MMTkTutorialPreliminaries-CreatingTheBaseTutorialCollector">Creating The Base Tutorial Collector</h5><ol><li>Copy the <code>org.mmtk.plan.nogc</code> package to <code>org.mmtk.plan.tutorial</code> (copy and paste the package in Eclipse).</li><li>Rename the constituent classes from <code>NoGC*</code> to <code>Tutorial*</code> (use Refactor-&gt;Rename on each class in Eclipse).</li><li>Create a new configuration file, <code>build/configs/BaseBaseTutorial.properties</code>, with a single line: <code>config.mmtk.plan=org.mmtk.plan.tutorial.Tutorial</code></li><li>Build and run the resulting collector:<ul><li><p>build with something like:<br /><br /></p><pre>bin/buildit localhost BaseBaseTutorial</pre><p> </p></li><li><p>run with something like:<br /><br /></p><pre>dist/BaseBaseTutorial_ia32-linux/rvm HelloWorld</pre><p> </p></li></ul></li></ol><div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Checkpoint</b><br /><p>This <a href="http://cs.anu.edu.au/people/Steve.Blackburn/misc/mmtk-tutorial/tutorial-00.patch" class="external-link" rel="nofollow">patch</a> captures all of the above steps with respect to Jikes RVM 3.0.1. You can use the patch to verify you've completed the above steps correctly.</p></td></tr></table></div>
                    </div>

                    
                 
                </div>             </div> 
            <div id="footer" style="background: url(http://docs.codehaus.org/images/border/border_bottom.gif) repeat-x;">
                <p><small>Document generated by Confluence on Feb 17, 2012 10:24</small></p>
            </div>
        </div>     </body>
</html>
